home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / qesum101.arc / QESSUMRY.DOC next >
Text File  |  1988-06-12  |  14KB  |  337 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                  QESSUMRY.EXE
  18.  
  19.  
  20.  
  21.                               Copyright (c) 1988
  22.                                 R. Mike Worley
  23.                                  Boise, Idaho
  24.  
  25.  
  26.  
  27.                             REGISTRATION & WARRANTY
  28.  
  29.     QESSUMRY is not warranted in any way, nor is it applicable to any specific
  30. application.  The user is solely responsible for any and all consequences
  31. resulting from the use of this program.  There are no known bugs in the
  32. program, but that doesn't mean you might not find one.
  33.  
  34.     QESSUMRY is offered under the Shareware concept.  You are free to try it to
  35. determine if it will meet your needs, and you are encouraged to upload program
  36. and documentation to bulletin boards.  If you continue to use this program, you
  37. are asked to register.  To register, complete the registration form on the last
  38. page of this documentation and send it to the address listed.  Users are asked
  39. to send a registration fee of $10.00.  If you do not feel you can afford the
  40. $10, but still like the program, please send the registration anyway.  I do ask
  41. that you register just so I will have an idea of the level of usage of this
  42. program.
  43.  
  44.  
  45.  
  46.                           PROGRAM SUMMARY and HISTORY
  47.  
  48.     QESSUMRY is a program to summarize data from bulletin board questionnaires
  49. developed for RBBS-PC.  The program will tally the number of responses for
  50. multiple choice and yes/no questions, and will calculate a response percentage
  51. for each choice.
  52.  
  53.     QESSUMRY will ignore questions requiring a text response, provided in-
  54. dividual the questions are named as outlined below.  It will also skip
  55. questions for which there have been no responses, as sometimes occurs when the
  56. questionnaire follows different paths depending on answers to previous
  57. questions.  Output can be to a Text File, a Printer, or to a Delimited Data
  58. File for use with database programs.  QESSUMRY will also create a special text
  59. file which integrates the actual questions from the questionnaire .DEF file
  60. with the response summaries.
  61.  
  62.     QESSUMRY started as QESTALLY, which was released in February, 1988.  Some
  63. users requested improvements to the program to make it more versatile in
  64. output.  The delimited data file output was immediately added, but before the
  65. revision was released, I noted a need to integrate the actual questions from
  66. the .DEF file with the answer summaries.  This creates a bulletin which shows
  67. the reader the question, the correct answer, and the summary of responses.  The
  68. revision was major enough to warrant renaming the program, and thus QESSUMRY
  69. was born.
  70.  
  71.  
  72.                             DEFINING THE QUESTIONS
  73.  
  74.     The RBBS-PC questionnaire is developed according to the directions in the
  75. RBBS-PC documentation.  Each questionnaire is named with a filename of up to
  76. eight characters with a mandatory extension of .DEF.  Questionnaires which will
  77. be summarized with QESSUMRY must follow these guidelines:
  78.  
  79.          1. The data file where the questionnaire responses are recorded MUST
  80.               have an extension of .DAT  .  The "Summarize Questionnaire"
  81.               option of QESSUMRY requires that both the .DAT and .DEF files
  82.               have the same file name.  If used the answer file must also have
  83.               the same filename.
  84.  
  85.               Therefore, the data file for UPLOAD.DEF (the questionnaire) would
  86.               have a data file named UPLOAD.DAT and an optional answer file
  87.               named UPLOAD.ANS.
  88.  
  89.          2. Multiple choice and yes/no questions MUST be designated by the
  90.               label "QUESTION", followed by a two-digit question number.  It is
  91.               preferable, but not necessary, that single-digit question numbers
  92.               by preceded by a zero.  According to the questionnaire develop-
  93.               ment criteria for RBBS-PC, labels are indicated by a colon (:).
  94.  
  95.               Therefore, multiple choice question number 2 would be labeled
  96.               :QUESTION02
  97.  
  98.               To avoid conflicts, questions requiring text input should have a
  99.               label other than "QUESTIONxx".  See Examples.
  100.  
  101.          3. QESSUMRY will summarize up to 15 multiple-choice or yes/no
  102.          questions per questionnaire, each with up to 8 choices.  Multiple
  103.          choice responses must be in the range A-H.  QESSUMRY is not case-
  104.          sensitive to responses, so both upper and lower case responses are
  105.          acceptable.  Yes/no questions must have the "yes" response listed
  106.          first.  (Responses must be Y/N - True/False or T/F responses are not
  107.          supported by QESSUMRY.)
  108.  
  109.  
  110.                               RUNNING THE PROGRAM
  111.  
  112.     QESSUMRY is a stand-alone executable program.  It must exist on the same
  113. drive/subdirectory as the questionnaire data file.  If you wish to use the
  114. Summarize Questionnaire option, the .DEF file for the questionnaire must also
  115. exist on the same drive/subdirectory.  Additionally, the .DAT and .DEF files
  116. must have the same file name. 
  117.  
  118.  
  119. Variation 1:
  120.  
  121.     To start the program, type QESSUMRY at the DOS prompt.  QESSUMRY will
  122. display its intro logo and ask for the name of the questionnaire data file. 
  123. You may enter either the filename alone, or with the extension of .DAT.  If the
  124. filename is entered without an extension, QESSUMRY will append .DAT to the
  125. filename.
  126.  
  127.     You will then be asked whether you want the output routed to a Database
  128. file, Text file, Printer or whether you want to Summarize the Questionnaire. 
  129. The default is to a text file.  See OUTPUT OPTIONS. 
  130.  
  131.  
  132. Variation 2:
  133.  
  134.     QESSUMRY may also be started by placing the output selection and filename
  135. on the command line.  The output selection follows the program name and is
  136. indicated by either "-" or "/".  The data filename follows the output selec-
  137. tion, and does NOT include an extension.
  138.  
  139. Example:  C:> QESSUMRY -D 300BAUD   will output the tally of responses to
  140. 300BAUD.DAT to a delimited data file called 300BAUD.DTA.
  141.  
  142.          C:> QESSUMRY /p upload will output the tally of responses to
  143. UPLOAD.DAT to the printer.
  144.  
  145.     NOTE:  If you use the command line option, you MUST include both the output
  146. specification and the filename.  You cannot omit either, and they must appear
  147. in the correct order.  Command line entries are not case-sensitive.
  148.  
  149.  
  150.                                 OUTPUT OPTIONS
  151.  
  152. Text [F]ile
  153.     The default output option is to a text file with the name <filename>.FIL. 
  154. This will create an ASCII text file on the default drive/subdirectory contain-
  155. ing the number of responses and a percentage breakdown of each response.
  156.  
  157. (P)rinter
  158.     If you select Printer, QESSUMRY will direct its output to your default
  159. printer.  This output will be in the same form as the text file output, but
  160. will be formatted to break properly on 11 inch paper.
  161.  
  162. (D)atabase File
  163.     If you select Datafile, QESSUMRY will direct its output to a file called
  164. <filename>.DTA.  There will be one text line for each question in the question-
  165. naire.  The file format is:
  166.          1) The word "QUESTION" followed by the question number 
  167.          2) the total number of responses to that question 
  168.          3-10) the number of responses to each choice A-H.  If the question is
  169.               a yes/no, "Y" responses will be in field 3 and "N" responses in
  170.               field 4.  Fields are delimited by commas.  
  171.  
  172.     NOTE:  This output is NOT of itself in any particular database format.  It
  173. is merely in the delimited format which can be imported by various database
  174. programs.
  175.  
  176. (S)ummarize Questionnaire
  177.     If you select Summarize Questionnaire, QESSUMRY will tally the responses. 
  178. It will then check for the existence of a file called <filename>.ANS.  This is
  179. the answer file for those questionnaires where there is a "correct" answer for
  180. each question.  If this file is located on the default drive/sub-directory,
  181. QESSUMRY will insert the correct answers into the output file.
  182.  
  183.     The answer file may have correct answers on one line, delimited by commas,
  184. or may have each answer on a separate line.  NOTE:  It is your responsibility
  185. to ensure that there are the proper number of answers for the number of
  186. questions in the questionnaire.  QESSUMRY will terminate abnormally if there
  187. are too few answers in the .ANS file for the number of questions.  Valid
  188. entries for the .ANS file are Y, N, or A-H.  Entries are not case-sensitive.
  189.  
  190.     If no .ANS file exists, you will be asked if you wish to provide "correct"
  191. answers to the questions.  If the questionnaire is of the general survey type
  192. where there is no "right" answer to the question, press "N".  If you do wish to
  193. provide "correct" answers, such as to a knowledge questionnaire, press "Y";
  194. QESSUMRY will then display each question in the questionnaire and prompt you
  195. for the correct answer.  In this form, only a one character response is
  196. accepted, but the responses are not case-sensitive.  
  197.  
  198.     The output of this option is to a text file named <filename>.SUM.
  199.  
  200. .FIL, .DTA, and .SUM files will be over-written each time their option is
  201. selected.
  202.  
  203.                                    EXAMPLES
  204.  
  205.     In the following example of an RBBS-PC questionnaire, the question :HOWMANY
  206. would be ignored by QESSUMRY.  The questionnaire outputs its information to a
  207. file called UPLOAD.DAT, which is the file that QESSUMRY would use to summarize
  208. the responses to this questionnaire.  (This example is not a complete question-
  209. naire)
  210.  
  211. "UPLOAD.DAT",7
  212. *
  213. :QUESTION01
  214. *How long have you been a user of this BBS?
  215. *
  216. *   A. New User (just signing on)
  217. *   B. Less than 1 month
  218. *   C. More than 1 month but less than 6 months
  219. *   D. More than 6 months but less than 1 year
  220. *   E. More than 1 year
  221. *
  222. ?Enter A, B, C, D, or E
  223. =AABORT=BHOWMANY=CHOWMANY=DHOWMANY=EHOWMANY= QUESTION01
  224. :HOWMANY
  225. *How many times do you estimate you have called this BBS?
  226. *
  227. ?
  228. :QUESTION02
  229. *
  230. *
  231. *Do you feel uploads should be allowed by all users.  (Y/N)
  232. *
  233. ?
  234. =YQUESTION04=NQUESTION03= QUESTION02
  235. *
  236. :QUESTION03
  237. *
  238. *Since you do not feel that all users should upload, how do you feel about
  239. *uploads?
  240. *
  241. *   A. The current policy should be maintained.
  242. *   B. No user uploads are necessary.
  243. *   C. I sign on here for the messages, not files.
  244. *   D. All of the above
  245. *   E. Both B and C
  246. *
  247. ?Enter A, B, C, D, or E
  248. =AEXIT=BEXIT=CEXIT=DEXIT=EEXIT= QUESTION03
  249. :QUESTION04
  250. *
  251. *There are several ways uploads can be handled.  Do you support:
  252. *
  253. *   A. All users should be required to upload in a certain proportion to
  254. *      the number of files they download.
  255. *   B. Users should be free to upload if they want, but should not be
  256. *      restricted from the number of files they download if they do not
  257. *      upload.
  258. *   C. Users should only be allowed to upload after a certain 'trial period'
  259. *      to be sure they will act responsibly.
  260. *   D. I've reconsidered - I think uploads should be discouraged on this BBS.
  261. *
  262. ?Enter A, B, C, or D
  263. =AQUESTION05=BQUESTION07=CQUESTION06=DQUESTION03= QUESTION04
  264.  
  265. ...
  266.  
  267.  
  268.  
  269.     This is an example of the Text file or Printer output from QESSUMRY. 
  270. Again, this is only a partial display, and is intended only as an example.
  271.  
  272.  
  273. QESSUMRY (c)                      UPLOAD.DAT                        06-11-1988
  274. ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::     11:04
  275.  
  276. Question 1                                                 Total Answers:   16
  277.  
  278.          Choice         # Responding                 Percentage
  279.  
  280.          A or Y:               0                        0.00 %
  281.          B or N:               4                       25.00 %
  282.          C:                    2                       12.50 %
  283.          D:                    5                       31.25 %
  284.          E:                    5                       31.25 %
  285.          F:                    0                        0.00 %
  286.          G:                    0                        0.00 %
  287.          H:                    0                        0.00 %
  288. ..............................................................................
  289.  
  290. Question 2                                                 Total Answers:   16
  291.  
  292.          Choice         # Responding                 Percentage
  293.  
  294.          A or Y:               9                       56.25 %
  295.          B or N:               7                       43.75 %
  296.          C:                    0                        0.00 %
  297.          D:                    0                        0.00 %
  298.          E:                    0                        0.00 %
  299.          F:                    0                        0.00 %
  300.          G:                    0                        0.00 %
  301.          H:                    0                        0.00 %
  302. ..............................................................................
  303.  
  304.  
  305.                                  REGISTRATION
  306.  
  307.                                    QESSUMRY
  308.  
  309.  
  310.  
  311. Name:___________________________________________________________
  312.  
  313. Address:________________________________________________________
  314.  
  315. City:____________________    State:______    Zip Code:__________
  316.  
  317.  
  318. Are you a SYSOP of an operating BBS?  ( ) Yes        ( ) No
  319.  
  320. If Yes, what is the data phone number for the BBS? ___________________
  321.  
  322.  
  323. Where did you obtain your copy of QESSUMRY?  ________________________________
  324.  
  325. If from a BBS, what is the name and number of the BBS? ______________________
  326.  
  327.  
  328.  
  329. OPTIONAL $10.00 Registration fee enclosed:  ( )
  330.  
  331.  
  332. Complete and send to:
  333.  
  334.                                 R. Mike Worley
  335.                                 P.O. Box 45321
  336.                                Boise, ID  83711
  337.